home *** CD-ROM | disk | FTP | other *** search
/ Risc World 3 / Risc World 3.iso / SOFTWARE / ISSUE3 / PD / VICE / doc / vice_3 < prev    next >
Text File  |  2002-09-01  |  4KB  |  170 lines
  1. <HTML>
  2. <HEAD>
  3. <!-- This HTML file has been created by texi2html 1.52
  4.      from ../vice.texi on 31 August 2002 -->
  5.  
  6. <TITLE>VICE Manual - 3  Invoking the emulators</TITLE>
  7. </HEAD>
  8. <BODY>
  9. Go to the <A HREF="vice_1.html">first</A>, <A HREF="vice_2.html">previous</A>, <A HREF="vice_4.html">next</A>, <A HREF="vice_16.html">last</A> section, <A HREF="vice_toc.html">table of contents</A>.
  10. <P><HR><P>
  11.  
  12.  
  13. <H1><A NAME="SEC20" HREF="vice_toc.html#TOC20">3  Invoking the emulators</A></H1>
  14.  
  15. <P>
  16. The names of the available emulators are:
  17.  
  18. </P>
  19.  
  20. <UL>
  21.  
  22. <LI>
  23.  
  24. <CODE>x64</CODE>, the C64 emulator
  25.  
  26. <LI>
  27.  
  28. <CODE>x128</CODE>, the C128 emulator
  29.  
  30. <LI>
  31.  
  32. <CODE>xpet</CODE>, the PET emulator
  33.  
  34. <LI>
  35.  
  36. <CODE>xvic</CODE>, the VIC20 emulator
  37.  
  38. <LI>
  39.  
  40. <CODE>xcbm2</CODE>, the CBM-II emulator
  41.  
  42. </UL>
  43.  
  44. <P>
  45. You can run each of them by simply typing the name from a shell.  If you
  46. want to run them from another application (e.g., a window manager or
  47. some other sort of program launcher) you should always run them from a
  48. terminal window such as <CODE>xterm</CODE> or <CODE>rxvt</CODE> since VICE provides
  49. a lot of debugging information that is sent to the terminal and has
  50. built-in monitor that also appears there.  For example, you could do
  51.  
  52. </P>
  53.  
  54. <PRE>
  55. xterm -e x64
  56. </PRE>
  57.  
  58.  
  59.  
  60. <H2><A NAME="SEC21" HREF="vice_toc.html#TOC21">3.1  Command-line options used during initialization</A></H2>
  61.  
  62. <P>
  63. There are several options you can specify on the command line.  Some of
  64. them are used to specify emulation settings and will be described in
  65. detail later (see section <A HREF="vice_6.html#SEC39">6  Settings and resources</A> for a complete list).  The
  66. remaining options are used only to give usage information or to
  67. initialize the emulator in some way:
  68.  
  69. </P>
  70. <DL COMPACT>
  71.  
  72. <DT><CODE>-help</CODE>
  73. <DD>
  74. <A NAME="IDX6"></A>
  75.  
  76. <A NAME="IDX7"></A>
  77. <DT><CODE>-?</CODE>
  78. <DD>
  79. List all the available command-line options and their meaning.
  80. <A NAME="IDX8"></A>
  81. <DT><CODE>-default</CODE>
  82. <DD>
  83. Set default resources (see section <A HREF="vice_6.html#SEC39">6  Settings and resources</A>).  This will
  84. override all the settings specified before, but not the settings
  85. specified afterwards on the command line.
  86. <A NAME="IDX9"></A>
  87. <DT><CODE>-autostart IMAGE</CODE>
  88. <DD>
  89. Autostart <TT>`IMAGE'</TT> (see section <A HREF="vice_3.html#SEC22">3.2  Autostarting programs from the command-line</A>).
  90. <A NAME="IDX10"></A>
  91. <DT><CODE>-1 NAME</CODE>
  92. <DD>
  93. Attach <TT>`NAME'</TT> as a tape image file.
  94. <A NAME="IDX11"></A>
  95. <DT><CODE>-8 NAME</CODE>
  96. <DD>
  97. <A NAME="IDX12"></A>
  98. <DT><CODE>-9 NAME</CODE>
  99. <DD>
  100. <A NAME="IDX13"></A>
  101. <DT><CODE>-10 NAME</CODE>
  102. <DD>
  103. <A NAME="IDX14"></A>
  104. <DT><CODE>-11 NAME</CODE>
  105. <DD>
  106. Attach <TT>`NAME'</TT> as a disk image to device 8, 9, 10 or 11.
  107. </DL>
  108.  
  109.  
  110.  
  111. <H2><A NAME="SEC22" HREF="vice_toc.html#TOC22">3.2  Autostarting programs from the command-line</A></H2>
  112.  
  113. <P>
  114. It is possible to let the emulator <EM>autostart</EM> a disk or tape image
  115. file, by simply specifying its name as the <EM>last</EM> argument on the
  116. command line, for example
  117.  
  118. </P>
  119.  
  120. <PRE>
  121. x64 lovelygame.x64.gz
  122. </PRE>
  123.  
  124. <P>
  125. will start the C64 emulator, attaching <TT>`lovelygame.x64.gz'</TT> as a
  126. disk image and running the first program on it.  You can also specify
  127. the name of the program on the fisk image by appending a colon
  128. (<SAMP>`:'</SAMP>) the name itself to the argument; for example
  129.  
  130. </P>
  131.  
  132. <PRE>
  133. x64 "lovelygame.x64.gz:run me"
  134. </PRE>
  135.  
  136. <P>
  137. will run the program named <TT>`run me'</TT> on <TT>`lovelygame.x64.gz'</TT>
  138. instead of the first one.
  139.  
  140. </P>
  141. <P>
  142. <A NAME="IDX15"></A>
  143. Using the command-line option <CODE>-autostart</CODE> is equivalent; so the same
  144. result can be obtained with
  145.  
  146. </P>
  147.  
  148. <PRE>
  149. x64 -autostart "lovelygame.x64.gz:run me"
  150. </PRE>
  151.  
  152. <P>
  153. If you specify a raw CBM or P00 file, the emulator will setup the file
  154. system based drive emulation so that it is enabled and accesses the
  155. directory containing the file first.  This is a very convenient way to
  156. start multi-file programs stored in file system directories and not
  157. requiring "true" drive emulation.
  158.  
  159. </P>
  160. <P>
  161. See section <A HREF="vice_5.html#SEC33">5.5  Using disk and tape images</A>. for more information about images and
  162. autostart.
  163.  
  164. </P>
  165.  
  166. <P><HR><P>
  167. Go to the <A HREF="vice_1.html">first</A>, <A HREF="vice_2.html">previous</A>, <A HREF="vice_4.html">next</A>, <A HREF="vice_16.html">last</A> section, <A HREF="vice_toc.html">table of contents</A>.
  168. </BODY>
  169. </HTML>
  170.